Amiga Plus 2000 #5/Amiga Plus CD - 2000 - No. 5.iso/t/AMPlifier_E.guide.bak.1

Text File | 2000-01-01 | 28KB | 1,134 lines

DATABASE "AMPlifier.guide"
@AUTHOR "Thorsten Hansen/ported by JP"
@-WORDWRAP

@NODE MAIN "AMPlifier Documentation"

                        @{b}AMPlifier@{ub}
                       Version 2.0

                    MPEG Audio Player

                 © 1999 Thorsten Hansen
                    @{i}Kato Development@{ui}

                  http://www.katodev.de

@{JLEFT}
  @{" Introduction            " LINK INTRODUCTION}   Why using it?
  @{" Requirements            " LINK REQUIREMENTS}   Things needed to get it work
  @{" Usage                   " LINK USAGE       }   How it works
  @{" Tooltypes and Arguments " LINK CONFIG      }   Configuration and Settings
  @{" ARexx                   " LINK AREXX       }   ARexx Port

  @{" Registration            " LINK REGISTRATION}   How to get a full License of AMPlifier

@ENDNODE


@NODE INTRODUCTION "Introduction"
@TOC MAIN
@{b}Introduction to AMPlifier@{ub}

AMPlifier primary is a playback tool for MPEG-Audio
(Musicam). Additionally it can be used to playback 16-bit
Sound stored into various file formats. AMPlifier makes it
possible to play MPEGs at nice and powerfull manner. It
may be used on any Amiga and supports hardware-based
decoding on one hand and software-based decodierung using
the mpega.library.

   supported hardware decoders actually are:

      Melody Z2, Melody1200+/pro, Peggy+ (ScalaMPEG),
      CD32-FMV


   as said before software decoding is using mpega.library
   and AHI or X-Audio depending on user's needs.


@{u}Features:@{uu}

  * Supports MPEG-Audio up to Layer III and even AIFF,
    MAUD, WAVE and RAW.

  * Ease of use, basic functionality known from CD-Players
    (play, pause, stop, forward, backward, skip back,
     skipforward)

  * Powerful plugin system - for external visualization plugins

  * Resizeable and configureable user interface - easy to use

  * Loads WinAMP skins (different gfx designs)

  * Opens and moves to/from any public screen on your choice

  * Nice and fast move to any position in a song by using
    a pos-slider

  * Powerfull Playlist (sortable, loop support).

  * Load, Save and Edit of playlists.

  * Random play

  * Simple drag&drop of files and drawers. (drop it over the
    playlist window to add it)

  * Recursive scan through directorys with pattern matching
    (drag&drop). with possibility to abort!
    (drop a drawer or volume on the player or playlist
     window)

  * ID3-Tag support to get closer and better infos from the
    songs played (artist, title, album, year,...)

  * Time remaining/elapsed display

  * ARexx port

  * Done as a Commodity

  ...


@ENDNODE


@NODE REQUIREMENTS "Hardware Requirements"
@TOC MAIN
@{b}Hardware and Softwarerequirements@{ub}

* AMPlifier works for any Amiga running AmigaOS 2.04 or
  better. While Developers machines are running OS 3.1 only
  the player is enhanced and checked with 3.1 only.
  Because of this the actual version 3 of the OS should
  be used.


* Regarding MPEG AMPlifier supports DSP based decoding of
  Soundboards and even simple Soundboards or output of
  traditional Amiga. If Software decoding is used only
  @{b}mpega.library@{ub} done by Stephan Tavenard is
  required.
  For hardware which supports MPEG a proper mpeg.device
  (CBM's  definition for CD32) is required and must be
  selected in the settings of AMPlifier.

@ENDNODE


@NODE USAGE "Usage"
@TOC MAIN
@{b}Usage@{ub}

AMPlifier may be started from Workbench or Shell.
The GUI is equvalent to the user interface of a generic
CD-Player.
At PullDown menue an additional playlist window may get
opened. It contains the list of songs which will be played.
By klicking one of the entries in the list it's possible to
start that song immediately. This mechanism may even be
used to skip one ore more songs or play one or more a
second time.

If songs are given to the player using Drag-and-Drop or the
filerequester (multiselect capability) the old playlist
will get removed and a new one containing the last choice
will show up. To add songs to the playlist they have to be
dropped over the playlist window or may get added with a
filerequester by using the ADD button.

Unkown file formats won't be accepted in default setup.
This may get changed via a a @{" Tooltype " LINK CONFIG}
to enable playback of headerless RAW samples
(Big-Endian, MSB first, Motorola).

The windows of player and playlist are variable in size.
While the sizegadget is visable at playlist, it's invisable
at the player itself. It's still there, though.


@{" Menus         " LINK MENUS}

@{" Player        " LINK WIN_PLAYER}
@{" Playlist      " LINK WIN_PLAYLIST}
@{" Configuration " LINK WIN_CONFIG}

@ENDNODE

@NODE MENUS "Menues"
@TOC USAGE
@{b}Menues@{ub}

@{" Project       " LINK MENU_PROJECT}
@{" Settings      " LINK MENU_SETTINGS}

@ENDNODE

@NODE MENU_PROJECT "Project"

@{b}@{u}Project@{ub}@{uu}

@{b}Open...@{ub}
  Opens an ASL-Filerequester for selecting songs to play

@{b}Add...@{ub}
  Opens an  ASL-Filerequester to add one song or a list of
  songs to playlist

@{b}Playlist...@{ub}
  Opens the window of the playlist.

@{b}Load Playlist...@{ub}
  Loading of an previously saved playlist.
  The name will be requested by a Filerequester.

@{b}Save Playlist...@{ub}
  Saves actual playlist into a file.

@{b}About@{ub}
  Displays a window which contains infos to AMPlifier an
  its designer/programmer.

@{b}Hide@{ub}
  Hides the GUI of the player. As this is a so called
  Commodity feature the tool Exchange (comes with the OS)
  may be used to redisplay it again.

@{b}Quit@{ub}
  This entry hopefully won't be used at all as it simply
  quits the programm. The function is equivalent to the
  close gadget at the player's window.

@ENDNODE

@NODE MENU_SETTINGS "Settings"

@{b}@{u}Settings@{uu}@{ub}

@{b}Configuration...@{ub}
  The item opens the configuration window of AMPlifier.

@{b}Random@{ub}
  If Random is checked titles in the list are played at
  random order.

@{b}Loop@{ub}
  After all songs are played the player doesn't stop but
  plays the list again (if checked).

@{b}Time Elapsed / Time Remaining@{ub}
  Switches display to time remaining instead of time
  elapsed.

@{b}Display@{ub}

  @{u}Standard GUI@{uu}

  @{b}Info@{ub}
    Activates the part of the GUI which displays the
    line which contains infos regaring the currently played
    song

  @{b}Slider@{ub}
    Activates position slider at the GUI.

  @{b}Panel@{ub}
    Activates the CD-Player panel of player's GUI

  @{u}Skin GUI@{uu}

  @{b}Select Skin...@{ub}
    It pops up a window  which shows the list of different
    skins which are available in the skins directory
    (look for at WinAMP skins in Internet if you like).
    The skins directory can be selected in the
    configuration window of the player.


@{b}Public Screen@{ub}
  This item opens a list window which contains the public
  screens on which AMPlifer may be moved to.

@{b}Snapshot@{ub}
  This one snaps position and size of the player windows
  and stores the information for the next start of the
  program.


@ENDNODE

@NODE WIN_PLAYER "Player"
@TOC USAGE
@{b}Player@{ub}

The userinterface was done euivalent to that one of a
generic CD player. Same functionality is available at
AMPlifier.

There are buttons for @{i}Play@{ui}, @{i}Stop@{ui}, @{i}Pause@{ui} and for
Skipping and Jump back to previously played songs.

The first way to do a list of songs for playback is
a filerequester which even allows multiselection.
It's even possible to choose the whole directory with the
filerequester if no file is selected.

The other and maybe easier way is to drag and drop
files, directories or even volumes over/into the
player window. In case of a directory or volume
AMPlifier will recursively scan it for files it's
able to play back. These files will be listed in the
playlist window.


@ENDNODE

@NODE WIN_PLAYLIST "Playlist"
@TOC USAGE
@{b}Playlist@{ub}

Like the name tries to tell this is the window which
includes and shows the list of titles to play.
Each file is displayed with length (min:secs) and
name.
MPEG-files may contain so called ID3 Tag informations
appended to the sound data. If such Tag is available
closer info will be or may be shown in the list.

In the top area of the playlist's window there are
buttons which represent functions for editing the
playlist. One or more files may be @{b}Add@{ub}ed to the
actual playlist. The filerequester supports selection of
multible files (shift key!).

There are buttions to @{b}Remove@{ub} entries or
@{b}Clear@{ub} the whole list. Additionally there is
a buttion to @{b}Sort@{ub} the list in alphabetical order.

As long as the player scans directories recursively
(volumes or directories, their subdirectories and so on)
there will be a temporary break button in the bottom of the
window. If will disappear when the scan is finished.
It was done to stop scans which take too long maybe
because of and accidently selected Workbench partition
or something equivalent.
Entries in the playlist which are/were played will change
from bold font to normal font.

A very special bonbon of the GUI is the XY-scrolling
Listview which does softscrolling using any font! Up to
programmers knowledge it's a unique GUI element at Amiga
up to now.

@ENDNODE

@NODE WIN_CONFIG "Configuration"
@TOC USAGE
@{b}Configuration@{ub}

@{" General       " LINK CFG_GENERAL}
@{" Display       " LINK CFG_DISPLAY}
@{" Output        " LINK CFG_Output}
@{" MPEG          " LINK CFG_MPEG}

@ENDNODE

@NODE CFG_GENERAL "General"
@TOC WIN_CONFIG
@{b}General@{ub}

@{b}@{u}Load@{uu}@{ub}

@{b}Check filetype information on load@{ub}
  This checkbox forces AMPlifier to check filetypes while
  building the playlist. Files of types it doesn't know
  won't be shown at the playlist.

  This confguration topic doesn't prevent AMPlifier to
  check any file before it plays it back, though.

@{b}ID3-Tag Info@{ub}
  ID3-Tag is an information block which may be appended to
  MPEG audio files. It usually contains title, interpret,
  style etc. A checked box tells AMPlifier to read this
  information out of the file.
  As some computers are quite slow (usually wrong
  blocksize of harddisk...take OS 3.1 and 2048 byte/block)
  it's even possible to select the time when AMPlifier has
  a look at the data. The options are 1st: while it builds
  the playlist or 2nd: when song starts playing.

  There is a coded string which defines the format of the
  display (have a look at the default settings to
  understand).

  No question a title which doesn't contain such info data
  won't allow AMPlifier to display the data!
  There are several tools which may be used to enter or
  modify ID3-Tags.

  As there is a problem with ID3 regarding broadcasting
  (it's starting to be available when the song finished)
  there is a new standard at the horizont. AMPlifier will
  even support it when it's finished.


@{b}Start playback@{ub}
  As said before the scan of a big or slow dataset may take
  a longer time. AMPlifier is able to start playback before
  the whole list is ready.
  The time (in seconds) it should wait until starting the
  first song may be entered here, too.

  Attention: If a very short time is choosen random play
  will allways start with the same song(s) for sure.


@{b}@{u}Misc@{uu}@{ub}

@{b}Song Dir@{ub}
  Default directory for songs.

@{b}Playlist Dir@{ub}
  Default directory for playlists.

@{b}Start File@{ub}
  This feature allows the user to pre-define a title or a
  directory of songs AMPlifier will start to play when
  just started.

@{b}File Pattern@{ub}
  File pattern limits the search for playable files by their
  extention (f.e. #?.mp3). As AMPlifier doesn't have to
  spend a look into each file it usually speeds up scanning
  by factors.

@{b}Activate on Doubleclick@{ub}
  If user is currently edditing the playlist in background
  it may be a bad idea to start playback of a song as soon
  as it's selected by a single mouse click.

  Activate on doubleclick transforms the behavior to
  1st: mark on single click and
  2nd: play this song now

  It's up to users chioce what's current optimum.

@ENDNODE

@NODE CFG_DISPLAY "Display"
@TOC WIN_CONFIG
@{b}Display@{ub}

@{b}Skins@{ub}
  Beside the traditional GUI which shows up by default, so
  called skins known from PC's WinAMP may be used. This
  drawn GUIs are often difficult to look at (not
  economical) and don't offer the feature of resizing.
  Regarding useablity they're bad but fresh and colorfull
  on the other hand.

  If skins are used the GUI includes a display area for
  @{i}Volume Meter@{ui}, @{i}Oscilloscope@{ui} or @{i}
  Spectrum Analyzer@{ui}. Click left below the time
  display for toggling

   (If Melody1200 with MPEG hardware support is build into
    the machine special hardware is used to display the
    analysis graphics!).

  At this area the directory which contains the skins
  may and should be entered.

  The Skins from PC world are done in Truecolor. If they're
  used at an Amigascreen which offers a lower number of
  colors (usually true for A1200) the may loog quite ugly.

  Even less colors look nice if color reduction is done.
  If the skin does't look very nice take color reduced ones
  or do the reduction yourself if you can.
  Sometimes there are stronger problems regarding display
  of skins. Usually the @{b}picture.datatype@{ub} is
  defective/old and slow. Take a new one!

  As soon as Skins are enabled a new menue bar will be
  shown in @{i}Settings@{ui} Menue.
  That's the place where skins may be changed and selected.

@ENDNODE

@NODE CFG_OUTPUT "Output"
@TOC WIN_CONFIG
@{b}Output@{ub}

@{b}Output Device@{ub}
  It's possible to select output drivers (device) and unit
  numbers for MPEG hardware and even simple audio output.
  If there is more than one board using the same driver
  you'll have to specify it by using unit numbers.

  For example it's even possible to use two Melody1200PRO
  in a A1200 (one on top of the other).
  Closer information available on request.

  @{b}MPEG@{ub}
    For  Melody 1200 pro and plus take 'mel1200mpeg.device'.
    Users of Peggy should enter 'peggympeg.device'.

  @{b}Audio@{ub}
    That's the name of the Audio Device
    (mel1200audio.device for all Melody1200 boards).

  @{b}Use AHI@{ub}
    If there are people who unfortunately don't have got
    a Melody1200 available in their A1200 or Zorro Amiga,
    AHI may be choosen.
    If AHI is used it's even possible to start more
    instances of AMPlifer and play back on the same
    hardware (AHI does the mixing).

@{b}File Buffer@{ub}
  That's the size of the overall file buffer. AMPlifer
  makes use of multibuffering for smooth playback.

  Blocksize specifies the size of one particular buffer.
  The overall buffersize is splitted into a calculated
  number of small buffers with the size of Blocksize.

  @{i}Attention:@{ui} If Peggy+, ScalaFMV is used, the
  maximum value is 5 kB only (bug in its device).

@{b}Audio@{ub}
  The size of the audio {b}Buffer@{ub} in seconds is
  selected here.
  If hardware baded decoding is used the value is ignored.
  It's used for playback of raw files and software based
  MPEG decoding, only.

  Primary when using software decoding there may be short
  interrupts when an MPEG file just started playback or the
  positioning slider is moved.
  To avoid these kind of short interrupts
  @{b}Pre-Buffering@{ub} may be used.
  Via this setting it's possible to define how much of the
  audio buffer has to be filled (in percent) until audible
  playback starts.

  Additionally the user may modify the @{b}Priority@{ub}
  of the audio Task. A priority of 20 or more is recomended
  in case of problems.
  Finally it strongly depends on the machine and its CPU
  which is used for playback.

@ENDNODE

@NODE CFG_MPEG "MPEG"
@TOC WIN_CONFIG
@{b}MPEG@{ub}

At the MPEG configuration user has got the choice of doing
software or hardware based decoding.
This can be configured seperately for MPEG Audio Layer I/II
and for Layer III.


@{i}Attention:@{ui} If DSP based decoding is wanted the options
           have to be @{b}disabled@{ub}. Otherwise the DSP won't
           be used and main CPU takes tons of work instead!


@ENDNODE

@NODE CONFIG "Configuration"
@TOC MAIN
@{b}Settings and Parameters@{ub}

There are several options which may selected via tooltypes
or as a parameter in the shell.

Following Tooltypes are available in programm's Icon:

@{b}CONFIG=Prefsfile@{ub}
  Prefsfile is a file into which AMPlifier stores its
  configuration. It's probably only usefull to change the
  name if there is more than one instance if AMPlifier
  running with different configuration.
  (Default: ENVARC:AMPlifier.prefs)

@{b}CX_POPUP=Yes/No@{ub}
  This Tooltype is a standard one of AmigaOS.
  If 'No' is entered, AMPlifier starts up as an AppIcon
  only. The GUI is not visable for first.
  This is equivalent to iconify in pull-down-menue of
  AMPlifier.

@{b}CX_POPKEY=Hotkey@{ub}
  Hotkey defines the kombination of keys which
  (re-)activates the GUI.
  (Default: @{i}shift-F1@{ui})

@{b}CX_PRIORITY=pri@{ub}
  Defines the startup priority of Commodity
  (standard feature)

@{b}MPEGDevice=MPEGDeviceName@{ub}
  This is where the Device Name of the MPEG Hardware is
  entered.
  For Melody 1200 pro und plus take 'mel1200mpeg.device'.
  Peggy User should take 'peggympeg.device' instead.

  (mpeg.device not xaudio.device !!!)

@{b}MPEGUnit=Nummer@{ub}
  Identification of more than one Soundboards using the
  same device (default: 0)

  (unit mpeg.device not xaudio.device !!!)

@{b}AudioDevice=AudioDeviceName@{ub}
  This is the name of the Audio Hardware.
  Regarding Melody1200 'mel1200audio.device' is the right
  choice.

  (xaudio.device not mpeg.device !!!)

@{b}AudioUnit=Nummer@{ub}
  Identification of more than one Soundboards using the
  same device (default: 0)

  (unit of xaudio.device not mpeg.device !!!)

@{b}BlockSize=Blocksize in KBytes@{ub}
  Blocksize specifies the size of one particular buffer.
  The overall buffersize is splitted into a calculated
  number of small buffers with the size of Blocksize.

@{b}BuffSize=Overall size of memory used for buffering@{ub}
  That's the size of the overall file buffer. AMPlifer
  makes use of multibuffering for smooth playback.

@{b}noAppIcon@{ub}
  The player doesn't show an AppIcon on Workbench.

@{b}PubScreen=ScreenName@{ub}
  Screenname is one of the allready opened Public
  Screens on which AMPlifier will open its GUI on.

@{b}AudioPri=Priorität@{ub}
  This is the priority of the Audio task (default 21)

@{b}RemainingTime@{ub}
  The player doesn't display time elapsed but the time
  remaining.

@{b}Pattern=\#?.(MP2|AIFF|WAV|MAUD)@{ub}
  At filerequesters only files matching the pattern are
  displayed.

@{b}Random@{ub}
  The Player plays all entries at random order instead
  of alphabetical order.

@{b}Loop@{ub}
  AMPlifier doesn't stop playback after the whole list
  is finished but restarts playback again.

@{b}CDDA@{ub}
  If CDDA is not activated, it's not possible to playback
  unknown filetypes which don't contain a header.
  By default it's deactivated to protect AMPlifier from
  playing back f.e. non-audio files.

@{b}CDDAIntel@{ub}
  For CDDA files (raw) there are two different orderings
  which have got their root at CPU level. The flag enables
  playback of foreign data.
  As CDDA is headerless it's usually required to check it
  out or know about the data before.

@{b}StopBeforeScan@{ub}
  Before AMPlifier plays back a new song it checks if
  knows the filetype.
  At some configurations it's a problem if one song is
  currently played and a second one is scanned to identify
  it. Using this flag AMPlifer will stop the previous
  song until having a look at the next one.

@{b}Visual=1,2,3@{ub}
  This is used to select the display which is used at the
  the skin GUI.
  1=Volume Meter, 2=Oscilloscope, 3=Spectrum Analyzer

@{b}SAScale=spectrum scale@{ub}
  This is the scaling of the frequency range at the
  Spectrum Analyzer Effect.

@{b}VisualPri=pri@{ub}
  This is the priority of the Visualization task

Many options are even available as shell arguments
The meaning is equivalent to the WB Tooltypes.

    FILENAME=StartFile
    CONF=CONFIGFILE
    CX_POPUP=<YES/NO>
    DEV=DEVICENAME
    U=UNIT
    BUFF=BUFFERSIZE
    BLOCK=BLOCKSIZE
    PS=PUBLICSCREEN


@ENDNODE

@NODE AREXX "ARexx"
@TOC MAIN

@{b}AMPlifier ARexx-Port@{ub}

The ARexx port of AMPlifier is accessable @{b}AMPLIFIER.1@{ub}.
Additional instance of AMPlifier gets the port @{b}AMPLIFIER.2@{ub}
and so on.

Following ARexx commands available at AMPlifier's port:

   @{" QUIT          " LINK QUIT}
   @{" HIDEGUI       " LINK HIDEGUI}
   @{" SHOWGUI       " LINK SHOWGUI}
   @{" OPEN          " LINK OPEN}
   @{" PLAY          " LINK PLAY}
   @{" STOP          " LINK STOP}
   @{" PLAYPAUSE     " LINK PLAYPAUSE}
   @{" PAUSE         " LINK PAUSE}
   @{" PLAYNEXT      " LINK PLAYNEXT}
   @{" PLAYPREV      " LINK PLAYPREV}
   @{" SELECT        " LINK SELECT}
   @{" QUERYSELECTED " LINK QUERYSELECTED}
   @{" SEEK          " LINK SEEK}
   @{" VOLUME        " LINK VOLUME}
   @{" WAIT          " LINK WAIT}
   @{" WAITABORT     " LINK WAITABORT}
   @{" ADD           " LINK ADD}
   @{" REM           " LINK REM}
   @{" CLEAR         " LINK CLEAR}
   @{" SORTLIST      " LINK SORTLIST}

   @{" PLAYSTATE     " LINK PLAYSTATE}
   @{" GETTIME       " LINK GETTIME}
   @{" GETLENGTH     " LINK GETLENGTH}
   @{" GETTAGINFO    " LINK GETTAGINFO}

@ENDNODE


@NODE QUIT "QUIT"
@TOC AREXX

@{b}@{u}QUIT@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Quits AMPlifier

@ENDNODE

@NODE HIDEGUI "HIDEGUI"
@TOC AREXX

@{b}@{u}HIDEGUI@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Hides graphical user interface

@ENDNODE

@NODE SHOWGUI "SHOWGUI"
@TOC AREXX

@{b}@{u}SHOWGUI@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Shows graphical user interface

@ENDNODE

@NODE OPEN "OPEN"
@TOC AREXX

@{b}@{u}OPEN@{uu}@{ub}

@{i}Template@{ui}
    TITLE/A

@{i}Description@{ui}
    Tries to open a file with name given

@ENDNODE

@NODE PLAY "PLAY"
@TOC AREXX

@{b}@{u}PLAY@{uu}@{ub}

@{i}Template@{ui}
    TITLE,INDEX/N/K

@{i}Description@{ui}
    If no argument is passed the current song is played;
    With argument given the specified file will be loaded
    if possible.
    If index argument is used the number of the entry in
    playlist is played (topmost argument is 0).

@ENDNODE

@NODE STOP "STOP"
@TOC AREXX

@{b}@{u}STOP@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Stops playback of current song

@ENDNODE

@NODE PLAYPAUSE "PLAYPAUSE"
@TOC AREXX

@{b}@{u}PLAYPAUSE@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Each call toggles play und pause

@ENDNODE

@NODE PAUSE "PAUSE"
@TOC AREXX

@{b}@{u}PAUSE@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Pauses playback of current song

@ENDNODE

@NODE PLAYNEXT "PLAYNEXT"
@TOC AREXX

@{b}@{u}PLAYNEXT@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Plays next title in playlist
    If random mode is activated, the next random title is
    played.

@ENDNODE

@NODE PLAYPREV "PLAYPREV"
@TOC AREXX

@{b}@{u}PLAYPREV@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Plays previous title

@ENDNODE

@NODE SELECT "SELECT"
@TOC AREXX

@{b}@{u}SELECT@{uu}@{ub}

@{i}Template@{ui}
    INDEX/N/K,NEXT/S,PREV=PREVIOUS/S,TOP/S,BOTTOM/S

@{i}Description@{ui}
    Selects titel in playlist

@ENDNODE

@NODE QUERYSELECTED "QUERYSELECTED"
@TOC AREXX

@{b}@{u}QUERYSELECTED@{uu}@{ub}

@{i}Template@{ui}
    PLAYED/S,INDEX/S,NAME/S,LABEL/S

@{i}Description@{ui}
    Returns informations to selected title in playlist

@ENDNODE

@NODE SEEK "SEEK"
@TOC AREXX

@{b}@{u}SEEK@{uu}@{ub}

@{i}Template@{ui}
    SEC/N/A

@{i}Description@{ui}
    Jumps to a specified position in actual title
    (seconds from start).

@ENDNODE

@NODE VOLUME "VOLUME"
@TOC AREXX

@{b}@{u}VOLUME@{uu}@{ub}

@{i}Template@{ui}
    LEVEL/N

@{i}Description@{ui}
    Set volume to (0-64).
    If no argument is passed actual volume is returned

@ENDNODE

@NODE WAIT "WAIT"
@TOC AREXX

@{b}@{u}WAIT@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Wait until song is finished (synchronous)

@ENDNODE

@NODE WAITABORT "WAITABORT"
@TOC AREXX

@{b}@{u}WAITABORT@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Breaks @{" WAIT " LINK WAIT} command

@ENDNODE

@NODE ADD "ADD"
@TOC AREXX

@{b}@{u}ADD@{uu}@{ub}

@{i}Template@{ui}
    TITLES/M

@{i}Description@{ui}
    Adds one or more files or directories from playlist

@ENDNODE

@NODE REM "REM"
@TOC AREXX

@{b}@{u}REM@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Removes an entry from playlist

@ENDNODE

@NODE CLEAR "CLEAR"
@TOC AREXX

@{b}@{u}CLEAR@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Clears playlist

@ENDNODE

@NODE SORTLIST "SORTLIST"
@TOC AREXX

@{b}@{u}SORTLIST@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Sorts playlist in alphabetical order

@ENDNODE

@NODE PLAYSTATE "PLAYSTATE"
@TOC AREXX

@{b}@{u}PLAYSTATE@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Ask for state of the players

@{i}Result@{ui}
    1=Stop
    2=Pause
    3=Playback

@ENDNODE

@NODE GETTIME "GETTIME"
@TOC AREXX

@{b}@{u}GETTIME@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Ask for time elapsed (per song).

@{i}Result@{ui}
    Time in seconds

@ENDNODE

@NODE GETLENGTH "GETLENGTH"
@TOC AREXX

@{b}@{u}GETLENGTH@{uu}@{ub}

@{i}Template@{ui}
    -

@{i}Description@{ui}
    Ask for length of current title

@{i}Result@{ui}
    Length in seconds

@ENDNODE

@NODE GETTAGINFO "GETTAGINFO"
@TOC AREXX

@{b}@{u}GETTAGINFO@{uu}@{ub}

@{i}Template@{ui}
    STEM/K

@{i}Description@{ui}
    Returns ID3-TAG informations into a
    pre-defined variable

@{i}Result@{ui}
    READY    0 - no ID3-TAG infos available
             1 - following infos are available

    TITLE
    ARTIST
    ALBUM
    YEAR
    COMMENT
    GENRE

@{i}Example@{ui}

    OPTIONS RESULTS

    ADDRESS AMPLIFIER.1

    GETTAGINFO STEM tag

    IF tag.ready = "1" THEN DO
      SAY "Title:" tag.title
      SAY "Artist:" tag.artist
      SAY "Album:" tag.album
      SAY "Year:" tag.year
      SAY "Comment:" tag.comment
      SAY "Genre:" tag.genre
    END

@ENDNODE

@NODE REGISTRATION "Registration"
@TOC MAIN

@{b}Registration@{ub}

@{u}Melody Users@{uu}
If you're proud owner of a Melody Z2/Melody 1200 Soundboard,
AMPlifier is unlimited for you. There is no need for
registration.

@{u}All others:@{uu}
AMPlifier is Shareware. If you're using it for a longer
time then about two weeks you have to register.

The shareware price is 15,- Euro,
                       30,- DM.

Registered users will receive a personal keyfile. Inside the
Keyfile your coded data is stored.
One license includes one computer only and for you it's
not allowed to give it to someone else.

Unless noted differently the common rules for shareware are
even true for AMPlifier.

The Keyfile will be send out uuencoded via EMail.

Following data is required:  Name
                             Address
                             EMail Address

The payage may be done directly via mail (money) or via the
account of my Bank. If you like to transfer to bank, ask for
my SWIFT etc.
At near future there will be additional ways (Eurocard) for
payage.

Thorsten Hansen
Geerzkamp 16a
22119 Hamburg
Germany

EMail: [e-mail]

@ENDNODE